---
title: Discord
description: 与 Discord 互动
---

import { BlockInfoCard } from "@/components/ui/block-info-card"

<BlockInfoCard 
  type="discord"
  color="#5865F2"
  icon={true}
  iconSvg={`<svg className="block-icon"
      
      
      
      viewBox='0 -28.5 256 256'
      version='1.1'
      xmlns='http://www.w3.org/2000/svg'
      xmlnsXlink='http://www.w3.org/1999/xlink'
      preserveAspectRatio='xMidYMid'
    >
      <g>
        <path
          d='M216.856339,16.5966031 C200.285002,8.84328665 182.566144,3.2084988 164.041564,0 C161.766523,4.11318106 159.108624,9.64549908 157.276099,14.0464379 C137.583995,11.0849896 118.072967,11.0849896 98.7430163,14.0464379 C96.9108417,9.64549908 94.1925838,4.11318106 91.8971895,0 C73.3526068,3.2084988 55.6133949,8.86399117 39.0420583,16.6376612 C5.61752293,67.146514 -3.4433191,116.400813 1.08711069,164.955721 C23.2560196,181.510915 44.7403634,191.567697 65.8621325,198.148576 C71.0772151,190.971126 75.7283628,183.341335 79.7352139,175.300261 C72.104019,172.400575 64.7949724,168.822202 57.8887866,164.667963 C59.7209612,163.310589 61.5131304,161.891452 63.2445898,160.431257 C105.36741,180.133187 151.134928,180.133187 192.754523,160.431257 C194.506336,161.891452 196.298154,163.310589 198.110326,164.667963 C191.183787,168.842556 183.854737,172.420929 176.223542,175.320965 C180.230393,183.341335 184.861538,190.991831 190.096624,198.16893 C211.238746,191.588051 232.743023,181.531619 254.911949,164.955721 C260.227747,108.668201 245.831087,59.8662432 216.856339,16.5966031 Z M85.4738752,135.09489 C72.8290281,135.09489 62.4592217,123.290155 62.4592217,108.914901 C62.4592217,94.5396472 72.607595,82.7145587 85.4738752,82.7145587 C98.3405064,82.7145587 108.709962,94.5189427 108.488529,108.914901 C108.508531,123.290155 98.3405064,135.09489 85.4738752,135.09489 Z M170.525237,135.09489 C157.88039,135.09489 147.510584,123.290155 147.510584,108.914901 C147.510584,94.5396472 157.658606,82.7145587 170.525237,82.7145587 C183.391518,82.7145587 193.761324,94.5189427 193.539891,108.914901 C193.539891,123.290155 183.391518,135.09489 170.525237,135.09489 Z'
          fill='currentColor'
          fillRule='nonzero'
        />
      </g>
    </svg>`}
/>

{/* MANUAL-CONTENT-START:intro */}
[Discord](https://discord.com) 是一个功能强大的通信平台，允许您与朋友、社区和团队连接。它提供了一系列团队协作功能，包括文字频道、语音频道和视频通话。

使用 Discord 账户或机器人，您可以：

- **发送消息**：向特定频道发送消息
- **获取消息**：从特定频道获取消息
- **获取服务器**：获取特定服务器的信息
- **获取用户**：获取特定用户的信息

在 Sim 中，Discord 集成使您的代理能够访问并利用您组织的 Discord 服务器。代理可以从 Discord 频道中检索信息、搜索特定用户、获取服务器信息并发送消息。这使您的工作流程能够与 Discord 社区集成，自动化通知并创建互动体验。

> **重要提示：** 要读取消息内容，您的 Discord 机器人需要在 Discord 开发者门户中启用“消息内容意图”。如果没有此权限，您仍然可以接收消息元数据，但内容字段将显示为空。

Sim 中的 Discord 组件使用高效的延迟加载，仅在需要时获取数据，以最大限度地减少 API 调用并防止速率限制。令牌刷新会在后台自动进行，以保持您的连接。

### 设置您的 Discord 机器人

1. 前往 [Discord 开发者门户](https://discord.com/developers/applications)
2. 创建一个新应用程序并导航到“机器人”选项卡
3. 创建一个机器人并复制您的机器人令牌
4. 在“特权网关意图”下，启用 **消息内容意图** 以读取消息内容
5. 使用适当的权限将您的机器人邀请到您的服务器
{/* MANUAL-CONTENT-END */}

## 使用说明

将 Discord 集成到工作流程中。可以发送和接收消息，获取服务器信息，以及获取用户信息。需要机器人 API 密钥。

## 工具

### `discord_send_message`

向 Discord 频道发送消息

#### 输入

| 参数 | 类型 | 必需 | 描述 |
| --------- | ---- | -------- | ----------- |
| `botToken` | string | 是 | 用于身份验证的机器人令牌 |
| `channelId` | string | 是 | 要发送消息的 Discord 频道 ID |
| `content` | string | 否 | 消息的文本内容 |
| `serverId` | string | 是 | Discord 服务器 ID \(公会 ID\) |
| `files` | file[] | 否 | 要附加到消息的文件 |

#### 输出

| 参数 | 类型 | 描述 |
| --------- | ---- | ----------- |
| `message` | string | 成功或错误消息 |
| `data` | object | Discord 消息数据 |

### `discord_get_messages`

从 Discord 频道检索消息

#### 输入

| 参数 | 类型 | 必需 | 描述 |
| --------- | ---- | -------- | ----------- |
| `botToken` | string | 是 | 用于身份验证的机器人令牌 |
| `channelId` | string | 是 | 要检索消息的 Discord 频道 ID |
| `limit` | number | 否 | 要检索的最大消息数 \(默认值: 10, 最大值: 100\) |

#### 输出

| 参数 | 类型 | 描述 |
| --------- | ---- | ----------- |
| `message` | string | 成功或错误消息 |
| `messages` | array | 包含完整元数据的 Discord 消息数组 |

### `discord_get_server`

检索 Discord 服务器（公会）的信息

#### 输入

| 参数 | 类型 | 必需 | 描述 |
| --------- | ---- | -------- | ----------- |
| `botToken` | string | 是 | 用于身份验证的机器人令牌 |
| `serverId` | string | 是 | Discord 服务器 ID \(公会 ID\) |

#### 输出

| 参数 | 类型 | 描述 |
| --------- | ---- | ----------- |
| `message` | string | 成功或错误消息 |
| `data` | object | Discord 服务器 \(公会\) 信息 |

### `discord_get_user`

检索 Discord 用户的信息

#### 输入

| 参数 | 类型 | 必需 | 描述 |
| --------- | ---- | -------- | ----------- |
| `botToken` | string | 是 | 用于身份验证的 Discord 机器人令牌 |
| `userId` | string | 是 | Discord 用户 ID |

#### 输出

| 参数 | 类型 | 描述 |
| --------- | ---- | ----------- |
| `message` | string | 成功或错误信息 |
| `data` | object | Discord 用户信息 |

## 注意事项

- 类别：`tools`
- 类型：`discord`
